home *** CD-ROM | disk | FTP | other *** search
/ Aminet 15 / Aminet 15 - Nov 1996.iso / Aminet / gfx / conv / mpeg.lha / mpeg.man < prev    next >
Text File  |  1993-06-16  |  9KB  |  179 lines
  1. MPEG(1)                  USER COMMANDS                    MPEG(1)
  2.  
  3. NAME
  4.      mpeg - MPEG compression and decompression
  5.  
  6. SYNOPSIS
  7.      mpeg [-d] [-NTSC] [-CIF] [-QCIF] [-PF] [-NPS]  [-MBPS  mbps]
  8.      [-UTC]
  9.           [-a StartNumber] [-b EndNumber]
  10.           [-h HorizontalSize] [-v VerticalSize]
  11.           [-f FrameInterval] [-g GroupInterval]
  12.           [-4] [-c] [-i MCSearchLimit] [-o] [-p PictureRate]
  13.           [-q Quantization] [-r Target Rate]
  14.           [-s StreamFile]  [-x Target Filesize] [-y]
  15.           [-z ComponentFileSuffix i]
  16.           ComponentFilePrefix1     [ComponentFilePrefix2     Com-
  17.      ponentFilePrefix3]
  18.  
  19. DESCRIPTION
  20.      mpeg      is      a      multimedia      image      sequence
  21.      compression/decompression  program that performs MPEG encod-
  22.      ing and decoding.
  23.  
  24. OPTIONS
  25.      -NTSC
  26.           indicates that the source frame size for the  Luminance
  27.           component is 352x240 and for the Chrominance components
  28.           is 176x120. This is the default size.
  29.      -CIF indicates that the source frame size for the  Luminance
  30.           component is 352x288 and for the Chrominance components
  31.           is 176x144.
  32.      -QCIF
  33.           indicates that the source frame size for the  Luminance
  34.           component is 176x144 and for the Chrominance components
  35.           is 88x72.
  36.      -PF  indicates that the component sizes specified by -h  and
  37.           -v  are  not  multiples  of 16 and furthermore that the
  38.           input files (or output files) should  be  exactly  that
  39.           specified  by  the component size -h and -v (or as read
  40.           from the compressed stream).  Otherwise the  input  and
  41.           output files will be the component size rounded up to a
  42.           multiple of 16 in each dimension.
  43.      -NPS The NPS option allows the  encoder  to  encode  without
  44.           having  the  restriction  that the last macroblock in a
  45.           slice cannot be  skipped.   For  coding  purposes,  the
  46.           first macroblock in a slice must be coded, although the
  47.           decoder will probably handle that case as well.
  48.      -MBPS
  49.           This specifies the  macroblocks  per  slice.   If  left
  50.  
  51. AT&T Bell Laboratories Last change: 24 February 1993                 1
  52.  
  53.  
  54. MPEG(1)                  USER COMMANDS                    MPEG(1)
  55.  
  56.           unspecified then the number of macroblocks per slice is
  57.           the number of macroblocks on one row of the image.
  58.      -UTC Forces the frame number  of  the  image  to  match  the
  59.           Group-of-Pictures  time  code.   Only  useful  for  the
  60.           decoder.
  61.      -a   denotes the following value to  be  the  start  of  the
  62.           filename index [inclusive]. Defaults to 0.
  63.      -b   denotes the following  value  to  be  the  end  of  the
  64.           filename index [inclusive]. Defaults to 0.
  65.      -d   enables the decoder.  The only options useful  for  the
  66.           decoder  are  the filename specifications and the -NPS,
  67.           -UTC commmands; the rest of the  command-line  informa-
  68.           tion is used for encoding.
  69.      -h   is the horizontal size of the picture in terms  of  the
  70.           luminance  component, used for a non -NTSC, -CIF, -QCIF
  71.           filesize.  See the preceding note about -PF  about  the
  72.           dimensions  of  the  file  relative to that of the com-
  73.           ponent.
  74.      -v   is the vertical size of the picture  in  terms  of  the
  75.           luminance  component, used for a non -NTSC, -CIF, -QCIF
  76.           filesize.  See the preceding note about -PF  about  the
  77.           dimensions  of  the  file  relative to that of the com-
  78.           ponent.
  79.      -f   is the  number  of  interpolated  frames  between  each
  80.           intra/predicted  frame.   FrameInterval-1 is the number
  81.           of interpolated frames within each frame interval.
  82.      -g   is the number of frame intervals per group-of-pictures.
  83.           With  a group interval of 1 then there are no predicted
  84.           frames.  The value GroupInterval-1  is  the  number  of
  85.           predicted frames in each group of pictures.
  86.      -4   is used to DC Intraframe mode where only  the  DC  com-
  87.           ponents of each picture block is coded.
  88.      -i   is the diameter of the motion  estimation  search.  The
  89.           diameter  must  be inclusively between 1 and 15, desig-
  90.           nating a region from interframe only (0,0)  search,  to
  91.           full search (+- 7.5, +- 7.5).  The motion estimation is
  92.           telescopic for frame distances  greater  than  1  (thus
  93.           having a greater effective range).
  94.      -o   signals that the program interpreter will read the con-
  95.           trol algorithms from the standard input.
  96.  
  97. AT&T Bell Laboratories Last change: 24 February 1993                 2
  98.  
  99.  
  100. MPEG(1)                  USER COMMANDS                    MPEG(1)
  101.  
  102.      -p   specifies the picture rate by a  code  directly  placed
  103.           into  the stream.  It must be a number between 0 and 8.
  104.           (default 5=30Hz).
  105.      -q   gives a value for the quantization not in the  presence
  106.           of rate control (rate control automatically changes the
  107.           quantization values).  If rate  control  is  specified,
  108.           this  parameter gives a value for the initial quantiza-
  109.           tion of the first  frame  (which  the  program  usually
  110.           takes an educated guess at).
  111.      -r   specified a rate for  the  coded  stream.  If  this  is
  112.           enabled,  a  buffer  model is used to limit the size of
  113.           the coding stream. Note  this  is  given  in  bits  per
  114.           second.
  115.      -s   specifies the filename to store  the  coded  image.  If
  116.           unspecified it defaults to ComponentFilePrefix0.mpg.
  117.      -v   designates that quantization decisions are to be  writ-
  118.           ten to standard output. This is the verbose mode.
  119.      -x   gives a target filesize for the compressed stream. This
  120.           overrides  the  rate  option  -r, if specified. This is
  121.           specified in bits.  The actual implementation  of  this
  122.           technique  is  through  calculating the equivalent bit-
  123.           rate. Since the buffer usually has some contents at the
  124.           end  of coding, the final filesize is larger than actu-
  125.           ally designated.
  126.      -y   enables the double-precision floating  point  Reference
  127.           DCT. The default is the Chen DCT.
  128.      -z   denotes  the  component  file  suffixes  in  sequential
  129.           order. For example
  130.            -z .y.clr -z .u.clr -z .v.clr indicates that the lumi-
  131.           nance  and  the two chrominance files end with a suffix
  132.           of .y.clr,  .u.clr,  and  .v.clr,  in  that  order.  If
  133.           unspecified, the suffixes default to .Y, U, and .V.
  134.      ComponentFilePrefixn
  135.           must be specified.  In  general,  the  other  component
  136.           files  share  the  same prefix and will default to Com-
  137.           ponentFilePrefix1 if not explicitly specified. However,
  138.           in  some  cases  the prefix is what changes in the file
  139.           and we can specify this individually.
  140.  
  141. EXAMPLES
  142.      To encode a set of raw raster scan YUV files with  dimension
  143.      352x240  Y,  176x120  U,V,  with  labels,  hello0.Y hello0.U
  144.      hello0.V,  hello1.Y  hello1.U   hello1.V,   ...,   hello12.Y
  145.      hello12.U hello12.V through the mpeg encoder, type
  146.  
  147. AT&T Bell Laboratories Last change: 24 February 1993                 3
  148.  
  149.  
  150. MPEG(1)                  USER COMMANDS                    MPEG(1)
  151.  
  152.      mpeg -a 0 -b 12 hello -s hello.mpg
  153.      This creates the output file hello.mpg. In order  to  decode
  154.      such a file into a sequence of image files with prefix good-
  155.      bye, type
  156.      mpeg -d -s hello.mpg goodbye
  157.      The output will be placed in the files goodbye0.Y goodbye0.U
  158.      goodbye0.V,    goodbye1.Y    goodbye1.U   goodbye1.V,   ...,
  159.      goodbye12.Y goodbye12.U goodbye12.V.  These image  sequences
  160.      can  be  displayed  by the cv program available by anonymous
  161.      ftp from havefun.stanford.edu:pub/cv/CVv1.1.tar.Z. There are
  162.      more options within an internal program interpreter.  Please
  163.      see  the  accompanying  documentation  in  doc.ps  for  more
  164.      details.
  165.  
  166. FTP
  167.      mpeg    is    available    by     anonymous     ftp     from
  168.      havefun.stanford.edu:pub/mpeg/MPEGv1.1.tar.Z.
  169.  
  170. BUGS
  171.      Somewhat  slower  than  many   commercial   implementations.
  172.      Please  inform  the  author at achung@cs.stanford.edu if any
  173.      bugs are found.
  174.  
  175. AUTHOR
  176.      Andy Hung
  177.  
  178. AT&T Bell Laboratories Last change: 24 February 1993                 4
  179.